@abraca/cli 2.3.0 → 2.5.0

package/README.md

@@ -0,0 +1,27 @@
+# @abraca/cli
+
+The `abracadabra` command-line client — read and mutate a space's tree, content, metadata, permissions, files, and presence from a terminal, plus a streaming Wikipedia importer.
+
+## Documentation
+
+Full, code-derived documentation lives in [`docs/`](docs/) — parsing/dispatch,
+connection & auth, the full command reference (read vs mutate), and the Wikipedia
+importer. It is the source of truth.
+
+## Usage
+
+```bash
+ABRA_URL=https://my-server.example.com abracadabra tree
+abracadabra read name="My Page"
+abracadabra write name="My Page" content="# Hello" mode=replace
+```
+
+`abracadabra [--flag] <command>[:<sub>] [key=value ...]`. Identity is an Ed25519 key file (`ABRA_KEY_FILE`, default `~/.abracadabra/cli.key`); auto-registers on first run. Docs are addressed via `id=`/`name=`/`path=`/positional. Output `--format=json|tsv|tree|text|md`.
+
+::
+
+> `abracadabra version` reports a hardcoded `1.0.0` (≠ package `2.4.0`). `delete` is a reversible soft-delete; `duplicate` is shallow; `chat` is a stateless `messages:send`. See [`docs/2.commands/reference`](docs/2.commands/1.reference.md).
+
+## License
+
+MIT.

package/dist/abracadabra-cli.cjs

@@ -1440,6 +1440,23 @@ function parseFrontmatter(markdown) {
 		body
 	};
 }
+function pushNested(out, inner, wrap) {
+	const children = parseInline(inner);
+	if (children.length === 0) {
+		out.push({
+			text: inner,
+			attrs: { ...wrap }
+		});
+		return;
+	}
+	for (const child of children) out.push({
+		text: child.text,
+		attrs: {
+			...child.attrs ?? {},
+			...wrap
+		}
+	});
+}
 function parseInline(text) {
 	const stripped = text.replace(/\{lang="[^"]*"\}/g, "").replace(/:(?!badge|icon|kbd)(\w[\w-]*)\[([^\]]*)\](\{[^}]*\})?/g, "$2").replace(/:(?!badge|icon|kbd)(\w[\w-]*)(\{[^}]*\})/g, "");
 	const tokens = [];
@@ -1488,22 +1505,10 @@ function parseInline(text) {
 				text: label,
 				attrs: { docLink: { docId } }
 			});
-		} else if (match[10] !== void 0) tokens.push({
-			text: match[10],
-			attrs: { strike: true }
-		});
-		else if (match[11] !== void 0) tokens.push({
-			text: match[11],
-			attrs: { bold: true }
-		});
-		else if (match[12] !== void 0) tokens.push({
-			text: match[12],
-			attrs: { italic: true }
-		});
-		else if (match[13] !== void 0) tokens.push({
-			text: match[13],
-			attrs: { italic: true }
-		});
+		} else if (match[10] !== void 0) pushNested(tokens, match[10], { strike: true });
+		else if (match[11] !== void 0) pushNested(tokens, match[11], { bold: true });
+		else if (match[12] !== void 0) pushNested(tokens, match[12], { italic: true });
+		else if (match[13] !== void 0) pushNested(tokens, match[13], { italic: true });
 		else if (match[14] !== void 0) tokens.push({
 			text: match[14],
 			attrs: { code: true }
@@ -2039,11 +2044,19 @@ function parseBlocks(markdown) {
 function fillTextInto(el, tokens) {
 	const filtered = tokens.filter((t) => t.text.length > 0);
 	if (!filtered.length) return;
-	const xtNodes = filtered.map(() => new yjs.XmlText());
-	el.insert(0, xtNodes);
+	const children = filtered.map((tok) => {
+		return (tok.attrs?.docLink)?.docId ? new yjs.XmlElement("docLink") : new yjs.XmlText();
+	});
+	el.insert(0, children);
 	filtered.forEach((tok, i) => {
-		if (tok.attrs) xtNodes[i].insert(0, tok.text, tok.attrs);
-		else xtNodes[i].insert(0, tok.text);
+		const node = children[i];
+		if (node instanceof yjs.XmlElement) {
+			const dl = tok.attrs.docLink;
+			node.setAttribute("docId", dl.docId);
+			return;
+		}
+		if (tok.attrs) node.insert(0, tok.text, tok.attrs);
+		else node.insert(0, tok.text);
 	});
 }
 function blockElName(b) {
@@ -2399,6 +2412,15 @@ function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled"
 
 //#endregion
 //#region packages/convert/src/yjs-to-markdown.ts
+function isXElem(n) {
+	return !!n && typeof n.nodeName === "string";
+}
+function isXText(n) {
+	return !!n && typeof n.nodeName !== "string" && typeof n.toDelta === "function";
+}
+function localizeFragment(fragment) {
+	return fragment;
+}
 function serializeDelta(delta) {
 	let result = "";
 	for (const op of delta) {
@@ -2459,12 +2481,15 @@ function serializeDelta(delta) {
 }
 function serializeInline(el) {
 	const parts = [];
-	for (const child of el.toArray()) if (child instanceof yjs.XmlText) parts.push(serializeDelta(child.toDelta()));
-	else if (child instanceof yjs.XmlElement) parts.push(serializeInline(child));
+	for (const child of el.toArray()) if (isXText(child)) parts.push(serializeDelta(child.toDelta()));
+	else if (isXElem(child)) if (child.nodeName === "docLink") {
+		const docId = child.getAttribute("docId") ?? "";
+		parts.push(`[[${docId}]]`);
+	} else parts.push(serializeInline(child));
 	return parts.join("");
 }
 function serializeBlock(el, indent = "") {
-	if (el instanceof yjs.XmlText) return serializeDelta(el.toDelta());
+	if (isXText(el)) return serializeDelta(el.toDelta());
 	switch (el.nodeName) {
 		case "documentHeader":
 		case "documentMeta": return "";
@@ -2484,7 +2509,7 @@ function serializeBlock(el, indent = "") {
 		}
 		case "blockquote": {
 			const lines = [];
-			for (const child of el.toArray()) if (child instanceof yjs.XmlElement) {
+			for (const child of el.toArray()) if (isXElem(child)) {
 				const text = serializeBlock(child);
 				for (const line of text.split("\n")) lines.push(`> ${line}`);
 			}
@@ -2545,11 +2570,11 @@ function serializeBlock(el, indent = "") {
 			if (to) props.push(`to="${to}"`);
 			return `::card${props.length ? `{${props.join(" ")}}` : ""}\n${serializeChildren(el)}\n::`;
 		}
-		case "cardGroup": return `::card-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		case "codeCollapse": return `::code-collapse\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
-		case "codeGroup": return `::code-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "cardGroup": return `::card-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeCollapse": return `::code-collapse\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeGroup": return `::code-group\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
 		case "codePreview": {
-			const children = el.toArray().filter((c) => c instanceof yjs.XmlElement);
+			const children = el.toArray().filter((c) => isXElem(c));
 			const nonCode = children.filter((c) => c.nodeName !== "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
 			const code = children.filter((c) => c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
 			const parts = [nonCode];
@@ -2567,16 +2592,16 @@ function serializeBlock(el, indent = "") {
 			if (required === true || required === "true") props.push("required=\"true\"");
 			return `::field{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
 		}
-		case "fieldGroup": return `::field-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "fieldGroup": return `::field-group\n${el.toArray().filter((c) => isXElem(c)).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
 		default: return serializeChildren(el);
 	}
 }
 function serializeChildren(el) {
 	const blocks = [];
-	for (const child of el.toArray()) if (child instanceof yjs.XmlElement) {
+	for (const child of el.toArray()) if (isXElem(child)) {
 		const text = serializeBlock(child);
 		if (text) blocks.push(text);
-	} else if (child instanceof yjs.XmlText) {
+	} else if (isXText(child)) {
 		const text = serializeDelta(child.toDelta());
 		if (text) blocks.push(text);
 	}
@@ -2586,11 +2611,11 @@ function serializeListItems(el, type, indent) {
 	const lines = [];
 	let counter = 1;
 	for (const child of el.toArray()) {
-		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "listItem") continue;
+		if (!isXElem(child) || child.nodeName !== "listItem") continue;
 		const prefix = type === "bullet" ? "- " : `${counter++}. `;
 		const subParts = [];
 		for (const sub of child.toArray()) {
-			if (!(sub instanceof yjs.XmlElement)) continue;
+			if (!isXElem(sub)) continue;
 			if (sub.nodeName === "bulletList") subParts.push(serializeListItems(sub, "bullet", indent + "  "));
 			else if (sub.nodeName === "orderedList") subParts.push(serializeListItems(sub, "ordered", indent + "  "));
 			else subParts.push(serializeInline(sub));
@@ -2606,13 +2631,13 @@ function serializeListItems(el, type, indent) {
 function serializeTaskList(el, indent) {
 	const lines = [];
 	for (const child of el.toArray()) {
-		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "taskItem") continue;
+		if (!isXElem(child) || child.nodeName !== "taskItem") continue;
 		const checked = child.getAttribute("checked");
 		const marker = checked === true || checked === "true" ? "[x]" : "[ ]";
 		let header = "";
 		const nestedParts = [];
 		for (const sub of child.toArray()) {
-			if (!(sub instanceof yjs.XmlElement)) continue;
+			if (!isXElem(sub)) continue;
 			if (sub.nodeName === "paragraph" && header === "") header = serializeInline(sub);
 			else if (sub.nodeName === "bulletList") nestedParts.push(serializeListItems(sub, "bullet", indent + "  "));
 			else if (sub.nodeName === "orderedList") nestedParts.push(serializeListItems(sub, "ordered", indent + "  "));
@@ -2625,16 +2650,16 @@ function serializeTaskList(el, indent) {
 	return lines.join("\n");
 }
 function getCodeBlockText(el) {
-	for (const child of el.toArray()) if (child instanceof yjs.XmlText) return child.toString();
+	for (const child of el.toArray()) if (isXText(child)) return child.toString();
 	return "";
 }
 function serializeTable(el) {
-	const rows = el.toArray().filter((c) => c instanceof yjs.XmlElement);
+	const rows = el.toArray().filter((c) => isXElem(c));
 	if (!rows.length) return "";
 	const serializedRows = [];
 	for (const row of rows) {
-		const cells = row.toArray().filter((c) => c instanceof yjs.XmlElement).map((cell) => {
-			return cell.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeInline(c)).join(" ");
+		const cells = row.toArray().filter((c) => isXElem(c)).map((cell) => {
+			return cell.toArray().filter((c) => isXElem(c)).map((c) => serializeInline(c)).join(" ");
 		});
 		serializedRows.push(cells);
 	}
@@ -2653,7 +2678,7 @@ function serializeTable(el) {
 	].join("\n");
 }
 function serializeSlottedContainer(el, containerName, childName, slotPrefix) {
-	return `::${containerName}\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === childName).map((item) => {
+	return `::${containerName}\n${el.toArray().filter((c) => isXElem(c) && c.nodeName === childName).map((item) => {
 		const label = item.getAttribute("label") ?? "";
 		const icon = item.getAttribute("icon") ?? "";
 		const props = [];
@@ -2703,6 +2728,7 @@ function escapeYaml(s) {
 	return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
 function yjsToMarkdown(fragment, label, meta, type) {
+	fragment = localizeFragment(fragment);
 	const { text: headerText, source: titleSource } = readDocumentHeader(fragment);
 	const effectiveTitle = headerText || label;
 	const docMeta = readDocumentMeta(fragment);
@@ -2726,7 +2752,7 @@ function readDocumentMeta(fragment) {
 	const meta = {};
 	let type;
 	for (const child of fragment.toArray()) {
-		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "documentMeta") continue;
+		if (!isXElem(child) || child.nodeName !== "documentMeta") continue;
 		const attrs = child.getAttributes();
 		for (const k of Object.keys(attrs)) {
 			const v = attrs[k];
@@ -2746,8 +2772,8 @@ function readDocumentMeta(fragment) {
 }
 function readDocumentHeader(fragment) {
 	for (const child of fragment.toArray()) {
-		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "documentHeader") continue;
-		const text = child.toArray().find((c) => c instanceof yjs.XmlText);
+		if (!isXElem(child) || child.nodeName !== "documentHeader") continue;
+		const text = child.toArray().find((c) => isXText(c));
 		const src = child.getAttribute("titleSource");
 		const source = src === "h1" || src === "frontmatter" ? src : void 0;
 		return {
@@ -2760,7 +2786,7 @@ function readDocumentHeader(fragment) {
 function collectBodyBlocks(fragment) {
 	const out = [];
 	for (const child of fragment.toArray()) {
-		if (!(child instanceof yjs.XmlElement)) continue;
+		if (!isXElem(child)) continue;
 		if (child.nodeName === "documentHeader" || child.nodeName === "documentMeta") continue;
 		out.push(child);
 	}
@@ -3704,17 +3730,17 @@ registerCommand({
 		const docId = resolveDocument(conn, args.params, args.positional);
 		if (!docId) return "Document not found. Specify id=, name=, or path= to identify the document.";
 		try {
-			const { title, markdown } = yjsToMarkdown((await conn.getChildProvider(docId)).document.getXmlFragment("default"));
+			const markdown = yjsToMarkdown((await conn.getChildProvider(docId)).document.getXmlFragment("default"), "");
 			if (args.flags.has("json") || args.params["format"] === "json") {
 				const treeMap = conn.getTreeMap();
-				let label = title;
+				let label = "";
 				let type;
 				let meta;
 				let children = [];
 				if (treeMap) {
 					const entry = treeMap.get(docId);
 					if (entry) {
-						label = entry.label || title;
+						label = entry.label || label;
 						type = entry.type;
 						meta = entry.meta;
 					}
@@ -4029,7 +4055,7 @@ registerCommand({
 		try {
 			const doc = (await conn.getChildProvider(docId)).document;
 			const fragment = doc.getXmlFragment("default");
-			const { markdown: existing } = yjsToMarkdown(fragment);
+			const existing = yjsToMarkdown(fragment, "");
 			const text = content.replace(/\\n/g, "\n").replace(/\\t/g, "	");
 			const combined = args.flags.has("inline") ? text + existing : text + "\n" + existing;
 			doc.transact(() => {
@@ -4052,7 +4078,7 @@ registerCommand({
 		const docId = resolveDocument(conn, args.params, args.positional);
 		if (!docId) return "Document not found.";
 		try {
-			const { markdown } = yjsToMarkdown((await conn.getChildProvider(docId)).document.getXmlFragment("default"));
+			const markdown = yjsToMarkdown((await conn.getChildProvider(docId)).document.getXmlFragment("default"), "");
 			const words = markdown.split(/\s+/).filter(Boolean).length;
 			const chars = markdown.length;
 			if (args.flags.has("words")) return String(words);
@@ -4074,7 +4100,9 @@ registerCommand({
 		const outputPath = args.params["output"] || args.params["to"] || args.params["path"];
 		if (!outputPath) return "Missing required parameter: output=<filepath>";
 		try {
-			const { title, markdown } = yjsToMarkdown((await conn.getChildProvider(docId)).document.getXmlFragment("default"));
+			const fragment = (await conn.getChildProvider(docId)).document.getXmlFragment("default");
+			const title = (conn.getTreeMap()?.get(docId))?.label;
+			const markdown = yjsToMarkdown(fragment, title ?? "");
 			const resolvedPath = node_path.resolve(outputPath);
 			node_fs.writeFileSync(resolvedPath, markdown, "utf-8");
 			return `Exported "${title || "document"}" to ${resolvedPath} (${Buffer.byteLength(markdown)} bytes)`;